Xbasic

FORM.DIALOG Function

Syntax

Last_Button as C = form.dialog(C layoutname [,C windowname [,C filter [,C order [,C queryFlags [,C position_x [,C position_y [,L ShowNewRecord [,* arguments ]]]]]]]])

Arguments

layoutname

The name of the form to open.

windowname

Optional. Not applicable.

filter

Optional. Default = ".T." (All records). A character filter expression that evaluates to a logical value and selects the records to show in the dialog. This filter is in addition to any filter specified in the form's Properties dialog box.

order

Optional. Default = record order. A character order expression that sorts selected records.

queryFlags

Optional. Sort instructions. "U" = Unique "D" = Descending

position_x

Optional. Horizontal position of dialog. Overrides any position settings defined in the form's Properties dialog box. Options are:

"Left"
"Right"
"Fill"
"Center"
An absolute position in pixels.

position_y

Optional. Vertical position of dialog. Overrides any position settings defined in the form's Properties dialog box. Options are:

"Top"
"Bottom"
"Fill"
"Center"
An absolute position in pixels.

ShowNewRecord

Optional. If ShowNewRecord is .T., and if the user specifies a Filter and no records satisfy the filter condition, then Alpha Anywhere will open the form ready to accept a new record. However, if ShowNewRecord is .F. then Alpha Anywhere does not open the dialog box, and the function returns "NoRecordsFound".

arguments

Description

The .DIALOG() method opens Form_Name as a dialog box. When the user closes the dialog, the object name of the last button pressed is stored in Last_Button. See Opening a Dialog Box for more information.

Example

xx = form.dialog("edit_customer_info", "", "recno()= 7711", "lastname", "", "right", "center", .f.)
? xx
= "NoRecordsFound"

Limitations

Desktop applications only.